.. _cmlGnGetCommStates:

cmlGnGetCommStates
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlGnGetCommStates ([in] VT_I4 BoardID, [in] VT_I4 Axis, 
    [in] VT_I4 cmltsId, [out] VT_PI4 CommStsVal)

DESCRIPTION
`````````````  

- cmlGnSetCommStates() 함수는통신 상태를 설정합니다. cmltsId에 따라 현재 통신 상태, 
  Real Time State Update Count 또는 Command Count 등을 설정할 수 있습니다.  
  cmlGnGetCommStates () 함수는 기존에 설정되어 있는 값을 반환합니다 .

\

- (단, 2014년 이후 이 함수는 통신 재시작에 대한 기능만을 제공합니다. 기존에 설정된 다른 
  설정값에 대한 부분은 추후에 제공될 예정입니다.) 

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의 첨두어 
  cml가 붙지 않습니다.  


PARAMETER
```````````````

▶ BoardID: 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis: Axis 번호, 축 번호는 3부터 시작합니다.. 
 
▶ cmltsId : 이 매개변수를 이용하여  어떤 통신 상태를 설정할 것인지를 선택합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   0 또는 cmlCSID_COM_STATES, 현재 통신 상태
   1 또는 cmlcSID_RTS_COUNT, Real Time State Update Count
   2 또는 cmlCSID_CMD_RST, Command Count
   3 또는 cmlSCID_COM_RST, 통신 리셋 (설정만 가능)


▶ CommStsVal: 선택한 cmStsId에 따라 각각 현재 통신 상태, Real Time State Update 
Count, Command Count 값을 설정 및 반환 합니다. 현재는 사용되지 않습니다.  

   
RETURN VALUE 
````````````````

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   음수, 수행 실패.
   ERR_NONE, 수행 성공.